趣链区块链浏览器¶
1. 功能概述¶
趣链区块链浏览器是管理人员可视化管理hyperchain相关链上业务的可视化工具,支持查看区块链上信息、节点/合约实例可视化管理等核心操作。
本使用手册将从启动趣链区块链浏览器、查看区块链浏览器、节点管理、合约实例管理等方面展开介绍。
2. 使用说明¶
2.1 快速启动¶
2.1.1 配置说明¶
使用区块链浏览器功能需要在hyperchain启动之前进行相关配置。主要配置项如下:
- system.toml
[baas] enable = true
在system.toml配置文件下,将bass.enable配置设置为true
- dynamic.toml
[port] ...... baas = 12001
在dynamic.toml配置文件下,配置baas的访问端口,默认为12001。即在hyperchain启动成功后,可以在浏览器访问 ip:12001 来打开区块链浏览器。
- 证书配置
趣链区块链浏览器通过sdk访问节点,故需要在节点的baas/conf目录下配置相关证书。
需要配置的证书及目录结构如下:
conf
├── certs
│ ├── sdkcert.cert
│ ├── sdkcert.priv
│ ├── unique.priv
│ └── unique.pub
│ ├── tls
│ │ ├── tls_peer.cert
│ │ ├── tls_peer.priv
│ │ └── tlsca.ca
注意,证书的配置取决于链上相关证书是否开启。
2.1.2 启动趣链区块链浏览器¶
您在部署hyperchain后,可获取目标节点的IP和端口信息(具体方式参见hyperchain部署手册),在相同域下的电脑设备内打开网页浏览器,在地址栏中输入对应的IP和端口,即可进入对应节点的趣链区块链浏览器。
示例:
2.2 区块链浏览器¶
区块链浏览器页面内,支持查看 实时总览数据 和 网络拓扑图 ,更进一步地,您可以从“区块”、“交易”两个维度进一步查看区块链数据。
2.2.1 查看区块¶
步骤一: 在搜索框中输入区块高度或区块哈希,或者点击【区块】tab下的【区块高度】,进入区块详情页。
步骤二: 在区块详情页中,可以查看区块详情和该区块下进行的交易,还可以继续搜索想要查看的区块和交易。其中,父区块哈希和交易哈希可以点击跳转至对应详情页,区块哈希、父区块哈希、Merkle树的根哈希可复制。
2.2.2 查看交易¶
步骤一: 在搜索框中输入交易哈希,或者点击【交易】tab下的【交易哈希】,进入交易详情页。
步骤二: 在交易详情页中,可以查看交易详情,还可以继续搜索想要查看的区块和交易。其中,区块哈希可以点击跳转至对应详情页,交易哈希、区块哈希、发起地址、接收地址可复制。
2.3 节点管理-节点信息¶
趣链区块链浏览器提供【节点信息】和【节点配置】两个可视化的节点管理页面。下文将介绍【节点信息】的使用说明,【节点配置】请参考2.4节内容。
2.3.2 节点连接状态管理¶
- 建立节点连接
步骤一: 点击【节点管理】下【节点信息】,进入节点信息页面。
步骤二: 在节点信息页面中,可以看到节点关联列表,点击【建立节点连接】。
步骤三: 在弹窗中填写待与当前节点关联的新节点参数,点击【确定】开始建立连接。
参数说明如下:
- 节点名称 :新节点的节点名称,不可与当前节点关联列表的节点名称相同;
- 节点IP地址 :新节点的端口信息,系统检验可连接后,即可建立新节点与当前节点的网络连接。
步骤四: 连接成功后,可在节点关联列表中查看。
- 重新连接节点
步骤一: 点击【节点管理】下【节点信息】,进入节点信息页面。
步骤二: 在节点信息页面中,可以看到节点关联列表,选择与当前节点建立连接的其他节点,点击【…】操作列的【重新连接】。
步骤三: 在弹窗内,点击“确定”,即可重新建立所选节点与当前节点之间的连接。
- 断开节点连接
步骤一: 点击【节点管理】下【节点信息】,进入节点信息页面。
步骤二: 在节点信息页面中,可以看到节点关联列表,选择与当前节点建立连接的其他节点,点击【…】操作列的【断开连接】。
步骤三: 在弹窗内,点击“确定”,即可断开所选节点与当前节点之间的连接,断开连接后该所选的节点将会从关联节点列表中消失,请谨慎操作。
- 节点链路检测
步骤一: 点击【节点管理】下【节点信息】,进入节点信息页面。
步骤二: 在节点信息页面中,可以看到节点关联列表,选择与当前节点建立连接的其他节点,点击【…】操作列的【链路检测】。
步骤三: 在弹窗内,您可以查看到链路检测结果。
2.4 节点管理-节点配置¶
2.4.1 节点网络配置¶
节点网络配置是针对节点Domain配置,支持新增Domain和修改Domain操作。
- 新增Domain
步骤一: 点击【节点配置】中【网络配置】,进入网络配置页面。
步骤二: 点击【新增Domain】,在新增行中,填写Domain参数,点击【保存】。
步骤三: 保存后,点击【更新网络配置】,网络配置更新成功。
- 修改Domain
步骤一: 点击【节点配置】中【网络配置】tab,进入网络配置页面。
步骤二: 选择列表中某个Domain,点击【修改】。在修改框中,重新填写Domain参数,点击【保存】。
步骤三: 保存后,点击【更新网络配置】,网络配置更新成功。
2.4.2 节点日志等级配置¶
- 查看当前日志等级
步骤一: 点击【节点配置】中,【日志等级】tab,进入日志等级配置页面。
步骤二: 在选择框中,选择系统级别或Namespace级别的日志等级,查看不同模块下日志等级配置。
- 修改日志等级配置
步骤一: 点击【节点配置】中,【日志等级】tab,进入日志等级配置页面。
步骤二: 点击【修改日志等级】,在弹窗中填写修改参数,点击【确定】,可修改日志等级。
每个分区模块的日志级别,日志级别由高到低为CRITICAL/ ERROR/WARNING/NOTICE INFO,级别越低日志内容越详细,对系统性能影响越大。
2.4.3 节点命名空间配置¶
节点命名空间配置提供可视化的 命名空间启动或停止 操作。
步骤一: 点击【节点配置】中,【命名空间】tab,进入命名空间配置页面。
步骤二: 选择某个命名空间,点击【启动】/【停止】按钮。
步骤三: 该节点会启动/停止在命名空间中的运行。
2.4.4 节点全量配置¶
步骤一: 点击【节点配置】中,【全量配置】tab,进入全量配置界面。
步骤二: 在左侧文件目录下,选择文件,进入编辑框修改配置。
步骤三: 修改完成后,点击【更新高级配置】,链将重启并完成配置更新。
2.5 合约实例¶
本模块提供对合约实例的管理操作。目前,支持Solidity合约实例和Java合约实例管理。
2.5.1 部署合约实例¶
前置条件:
- 已编写完成的合约文件,并有编译文件;
- 准备私钥文件(用于当前账户部署的合约实例的操作授权);
- 当前节点连接正常;
- 联盟链正常运行。
操作步骤:
- 点击【合约实例】tab,进入合约实例页面;
- 点击【上传私钥】,上传合约部署、升级等操作时需要使用的私钥,点击【确定】;
- 私钥上传完成后,点击【部署合约实例】,在弹窗中填写部署参数,点击【确定】,开始部署合约;
参数说明:
- 合约实例类型: 支持Solidity和Java两种合约类型
- 可选入参: 部署合约实例的初始化参数,如没有可不填
- 合约文件: 对于Solidity合约需分别上传编译后的abi文件和bin文件;对于Java合约需分别上传编译后的abi文件和jar文件
- 部署成功后,合约实例列表中将自动更新该合约实例,其状态为【运行中】。
2.5.2 查看合约实例¶
前置条件 :合约已完成部署。
操作步骤 :
- 点击【合约实例】tab,进入合约实例页面;
- 选择目标合约实例,点击【查看】,可进入合约实例详情页;
- 如下所示,在详情页可查看合约实例地址、合约类型、部署地址、合约调用记录等。
2.5.3 调用合约实例¶
前置条件 :
- 在合约实例列表中,已有合约实例,且状态为【运行中】;
- 联盟链处于正常运行状态。
操作步骤 :
- 点击【合约实例】tab,进入合约实例页面;
- 选择某个合约实例,点击【调用】;
- 弹窗中,填写调用参数,点击【确定】。
Solidity合约调用参数说明
参数名 | 填写说明 |
---|---|
函数名 | 该合约实例的调用函数名 |
可选入参 | 该合约的调用参数,如没有可不填 |
合约文件 | 该合约编译后的abi文件 |
Solidity合约调用示例
Java 合约调用参数说明
参数名 | 填写说明 |
---|---|
BeanName | 该合约实例的调用方法名 |
可选入参 | 该合约的调用参数,如没有可不填 |
合约文件 | 该合约编译后的abi文件 |
Java合约调用示例
- 调用成功,会跳出调用结果的详情弹窗,可查看调用信息,点击蓝色字符串【交易哈希】,可进行跳转至对应的区块链浏览器交易详情页,或者您也可在合约详情中查看调用记录。
2.5.4 升级合约实例¶
前置条件:
- 在合约实例列表中,已有合约实例,且状态为【运行中】;
- 链处于正常运行状态。
操作步骤 :
- 点击【合约实例】tab,进入合约实例页面;
- 选择目标合约实例,点击【升级】;
- 弹窗中填写升级参数,点击【确定】,合约开始升级;
Solidity合约升级参数说明
参数名 | 填写说明 |
---|---|
可选入参 | 该合约的调用参数,如没有可不填 |
合约文件 | 分别上传该合约编译后的abi文件与bin文件 |
Java 合约升级参数说明
参数名 | 填写说明 |
---|---|
可选入参 | 该合约的调用参数,如没有可不填 |
合约文件 | 分别上传该合约编译后的abi文件与bin文件 |
- 升级成功后,列表将自动刷新,且在合约实例详情中将新增相应的升级记录信息。
2.5.5 冻结合约实例¶
由于区块链网络中,数据一旦上链就不可篡改,那么对于合约也一样,一旦部署上链就不可以被删除。但是,会出现用户不需要使用合约或合约出现问题需要暂停使用的情况,针对这一问题,平台提供了合约冻结功能,可以暂停合约的使用。
前置条件 :
- 在合约实例列表中,已有合约实例,且状态为【运行中】;
- 链处于正常运行状态。
操作步骤 :
- 点击【合约实例】tab,进入合约实例页面;
- 选择某个合约实例,点击【冻结】;
- 冻结成功后,列表将自动刷新,合约状态更新为【已冻结】。
2.5.6 解冻合约实例¶
前置条件 :
- 在合约实例列表中,已有合约实例,且状态为【已冻结】;
- 联盟链处于正常运行状态。
操作步骤 :
- 点击【合约实例】tab,进入合约实例页面;
- 选择某个【已冻结】的合约实例,点击【解冻】;
- 在弹窗中点击确定;
- 解冻成功后,列表将自动更新,合约状态更新为【运行中】。
3. 注意事项¶
- 区块链浏览器为节点级别功能,目前监控功能仅针对global分区,后续版本将完善
- cvp节点暂不支持区块链浏览器开启
- 区块链浏览器相关日志保存在节点目录下的baas/logs
- 当前版本暂不支持部署java合约